<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" dir="ltr" lang="en-US" xml:lang="en-US">
	<head profile="http://gmpg.org/xfn/11">
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
		<title>Category Tags - 68KB User Guide</title>
		<link href="../../css/style.css" rel="stylesheet" type="text/css" media="all" />
		<script type="text/javascript" src="../../js/jquery.min.js"></script>
		<script type="text/javascript" src="../../js/main.js"></script>
		<script type="text/javascript" src="../../js/nav.js"></script>
		<meta http-equiv='expires' content='-1' />
		<meta http-equiv='pragma' content='no-cache' />
		<meta name='robots' content='all' />
	</head>
	<body>
		<div id="panel">
			<div id="panel_contents">
				<script type="text/javascript">create_menu('../../');</script>
			</div>
		</div>
		<div id="header">
			<div class="container_16">
				<div id="logo">
					<div class="grid_10 logo_img">
						<img src="../../images/logo-68kb.png" alt="logo" width="181" height="53" /> <a name="top" id="top"></a>
					</div>
					<div class="grid_6">
						<div class="panel_button" style="visibility: visible;">
							<a class="open" href="../../toc.html">Table of Contents</a>
						</div>
						<div class="panel_button" id="hide_button" style="display: none;">
							<a class="close" href="#">Close</a>
						</div>
					</div>
					<div class="clear"></div>
					<div id="title_area" class="grid_9">
						<h4>User Guide v2.0.0</h4>
					</div>
					<div class="grid_7 search_area">
						<form method="get" action="http://www.google.com/search">
							<input type="hidden" name="as_sitesearch" id="as_sitesearch" value="68kb.com/user_guide/" /><input id="search" type="text" size="31" maxlength="255" name="s" value="Search the user guide" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" />
						</form>
					</div>
					<div class="clear"></div>
				</div>
			</div>
		</div>
		<p>
			<br class="clear" />
		</p>
		<div class="container_16 main">
			<div id="content" class="grid_16">
				<div id="breadcrumb">
					<a href="http://68kb.com/">68KB Home</a>  &rarr; 
					<a href="../../index.html">User Guide Home</a>   &rarr; 
					<a href="../tags.html">Theme Tags</a>   &rarr; 
					Category Tags
				</div>
				
				<h1>Category Tags</h1>
				
					<p>68KB has two methods for getting a list of categories. They are:</p>
					
					<ol>
						<li><a href="#cat_list">Categories List</a></li>
						<li><a href="#table">Categories Table</a></li>
					</ol>
					
					<h2 id="cat_list">Category List</h2>
					
					<p>The {kb:categories:cat_list} tag is used to generate a html list of categories any where on your site. </p>
					
					<p>Here is an example usage: </p>
					
<code>
{kb:categories:cat_list }
</code>
					
					<p>Inside the block you can access any column from the db. {kb:article_hits}, {kb:article_date}, etc. </p>
					<h2>Category List Parameters</h2>
					
					<table cellpadding="0" cellspacing="1" border="0" style="width:100%" class="tableborder">
					<tr>
						<th> Name </th>
						<th> Type </th>
						<th> Default </th>
						<th> Description </th>

					</tr>
					<tr>
						<td class="td">cat_parent </td>
						<td class="td"> int </td>
						<td class="td"> 0 </td>
						<td class="td"> Is the starting parent category. </td>
					</tr>
					<tr>
						<td class="td"> sort_column </td>
						<td class="td"> string </td>
						<td class="td"> cat_order </td>
						<td class="td"> The db column to sort </td>

					</tr>
					<tr>
						<td class="td"> sort_order </td>
						<td class="td"> string </td>
						<td class="td"> desc </td>
						<td class="td"> The sorting order. (asc, or desc) </td>
					</tr>
					<tr>
						<td class="td"> depth </td>
						<td class="td"> int </td>
						<td class="td"> 0 </td>
						<td class="td"> The depth of the tree you want returned.   </td>
					</tr>
					<tr>
						<td class="td"> show_total </td>
						<td class="td"> (yes or no) </td>
						<td class="td"> no </td>
						<td class="td"> Do you want to display the total number of articles. <strong>Please note this can be slow.</strong>    </td>
					</tr>
					<tr>
						<td class="td"> exclude </td>
						<td class="td"> int </td>
						<td class="td"> 0 </td>
						<td class="td"> Any categories to exclude. Example: exclude=1,2,3    </td>
					</tr>
				</table>
				
				<h2 id="table">Category Table</h2>
					
					<p>The {kb:categories:table} tag is used to generate a html table of categories any where on your site. </p>
					
					<p>Here is an example usage: </p>
					
<code>
{kb:categories:table heading="Categories" cat_parent="0" cols="3" show_total="yes"}
</code>
					
					<h2>Category Table Parameters</h2>
					
					<table cellpadding="0" cellspacing="1" border="0" style="width:100%" class="tableborder">
					<tr>
						<th> Name </th>
						<th> Type </th>
						<th> Default </th>
						<th> Description </th>

					</tr>
					<tr>
						<td class="td">heading </td>
						<td class="td"> string </td>
						<td class="td"> - </td>
						<td class="td"> This creates an h2 heading above the category. </td>
					</tr>
					<tr>
						<td class="td">cat_parent </td>
						<td class="td"> int </td>
						<td class="td"> 0 </td>
						<td class="td"> Is the starting parent category. </td>
					</tr>
					<tr>
						<td class="td"> sort_column </td>
						<td class="td"> string </td>
						<td class="td"> cat_order </td>
						<td class="td"> The db column to sort </td>

					</tr>
					<tr>
						<td class="td"> sort_order </td>
						<td class="td"> string </td>
						<td class="td"> desc </td>
						<td class="td"> The sorting order. (asc, or desc) </td>
					</tr>
					<tr>
						<td class="td"> depth </td>
						<td class="td"> int </td>
						<td class="td"> 0 </td>
						<td class="td"> The depth of the tree you want returned.   </td>
					</tr>
					<tr>
						<td class="td"> show_total </td>
						<td class="td"> (yes or no) </td>
						<td class="td"> no </td>
						<td class="td"> Do you want to display the total number of articles. <strong>Please note this can be slow.</strong>    </td>
					</tr>
					<tr>
						<td class="td"> cols </td>
						<td class="td"> int </td>
						<td class="td"> 2 </td>
						<td class="td"> Number of table columns </td>
					</tr>
					<tr>
						<td class="td"> table_attr </td>
						<td class="td"> string </td>
						<td class="td"> width="100%" class="cat_table" </td>
						<td class="td"> Table attributes </td>
					</tr>
				</table>

			</div>
			<div class="clear"></div>
		</div>
		
		<br class="clear" />
		
		<div class="container_16 footer">
			<div class="grid_8">
				<p class="copy">
					&copy; 2010 68KB - All Rights Reserved.<br />
					A division of <a href="http://68designs.com">68 Designs, LLC</a>
				</p>
			</div>
			<div class="grid_8 top">
				<p>
					<a href="#top">Back to Top</a>
				</p>
			</div>
		</div>
	</body>
</html>